home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_urt.idb / usr / freeware / catman / u_man / cat1 / rleClock.Z / rleClock
Encoding:
Text File  |  1999-01-26  |  8.5 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      RRRRLLLLEEEECCCCLLLLOOOOCCCCKKKK((((1111))))         1111 ((((DDDDeeeecccc 11111111,,,,    1111999988887777))))           RRRRLLLLEEEECCCCLLLLOOOOCCCCKKKK((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       rleClock - Generate a    clock face in RLE format
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       rrrrlllleeeeCCCClllloooocccckkkk [ _o_p_t_i_o_n_s ] [ ----oooo _o_u_t_f_i_l_e ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.       This program generates an analog clock face in _R_L_E(5)    file
  16.       format and writes it to _o_u_t_f_i_l_e or standard output.  The
  17.       picture is a standard    clock face with    optional digital
  18.       representation above.     The user has control over the colors
  19.       of the portions of the clock face, the text, and the text
  20.       background.  The user    also has control over the clock
  21.       configuration: number    of ticks, scale    of the big and little
  22.       hands, the values of the big and little hands, and the
  23.       format used to generate the digital portion.
  24.  
  25.       By default, rrrrlllleeeeCCCClllloooocccckkkk generates a standard analog clock face
  26.       displaying the current time and with no digital portion.
  27.       This default face is transparent, that is, the alpha channel
  28.       is only defined for the clock    outline, tick marks, and the
  29.       hands.
  30.  
  31.       On those options that    expect colors, three numbers must be
  32.       given    after the option switch.  These    are values for red,
  33.       green, and blue on a scale of    zero through 255.  Those color
  34.       options that are capitalized indicate    the colors for the
  35.       filled regions (optional for the clock face and text but
  36.       default for the hands).  Those that are not capitalized are
  37.       for lines that either    outline    or constitute the feature (the
  38.       clock    face is    default, but they're optional for the hands).
  39.  
  40.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  41.       ----hhhheeeellllpppp
  42.            Prints a    synopsis of the    options.
  43.  
  44.       The options that control the value displayed by the clock
  45.       are
  46.  
  47.       ----llllssss _F_L_O_A_T
  48.            This specifies the full scale (360 degrees) of the
  49.            little hand.  Default is    12.
  50.  
  51.       ----llllvvvv _F_L_O_A_T
  52.            This specifies the value    of the little hand, expressed
  53.            in units    of the little hand full    scale.    Default    is the
  54.            current hour time on a 12-hour scale.
  55.  
  56.       ----bbbbssss _F_L_O_A_T
  57.            This specifies the full scale (360 degrees) of the big
  58.            hand.  Default is 60.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 12/1/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RRRRLLLLEEEECCCCLLLLOOOOCCCCKKKK((((1111))))         1111 ((((DDDDeeeecccc 11111111,,,,    1111999988887777))))           RRRRLLLLEEEECCCCLLLLOOOOCCCCKKKK((((1111))))
  71.  
  72.  
  73.  
  74.       ----bbbbvvvv _F_L_O_A_T
  75.            This specifies the value    of the big hand, expressed in
  76.            units of    the big    hand full scale.  Default is the
  77.            current minute time.
  78.  
  79.       The following    options    manage the display configuration of
  80.       the clock:
  81.  
  82.       ----xxxx _I_N_T
  83.            The INT specifies the width of the clock    in pixels.
  84.            Default is 128.
  85.  
  86.       ----ccccyyyy _I_N_T
  87.            The INT specifies the height of the clock face (minus
  88.            text portion) in    pixels.     The default is    128.
  89.  
  90.       ----ttttyyyy _I_N_T
  91.            The INT specifies the height in pixels of the text
  92.            portion of the display.    If it is zero (the default),
  93.            no text portion is displayed.
  94.  
  95.       ----tttt _I_N_T
  96.            This specifies the number of tick marks to place    around
  97.            the clock.  The default is 12.
  98.  
  99.       ----llllwwww _I_N_T
  100.            This specifies the line width in    pixels of the clock
  101.            face, the tick marks, the optional hand borders,    and
  102.            the text.  The default is one, but two or three give
  103.            better looking clocks.
  104.  
  105.       ----ttttffff _S_T_R
  106.            The string describes how    to show    the digital portion of
  107.            the clock.  The rules for forming STR are the same as
  108.            for _p_r_i_n_t_f format strings, that is, a percent sign,
  109.            optionally followed by field width values, followed by
  110.            a key letter.  In this case, the    key letter may be bbbb,,,,
  111.            llll,,,, BBBB,,,, or    LLLL.... Lower case bbbb    means to insert    the integer
  112.            value of    the big    hand and upper case BBBB means to insert
  113.            the floating point value    of the big hand.  Lower    case llll
  114.            means to    insert the integer value of the    little hand
  115.            and upper case LLLL    means to insert    the floating point
  116.            value of    the little hand.
  117.  
  118.       ----ffffcccc _R    _G _B
  119.            This specifies the color    in red,    green, and blue, of
  120.            the clock face.
  121.  
  122.       ----FFFFcccc _R    _G _B
  123.            This specifies the color    to fill    in inside the clock
  124.            face, under the hands.  If this option is not supplied,
  125.            the clock is generated with no inside-face background
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 12/1/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      RRRRLLLLEEEECCCCLLLLOOOOCCCCKKKK((((1111))))         1111 ((((DDDDeeeecccc 11111111,,,,    1111999988887777))))           RRRRLLLLEEEECCCCLLLLOOOOCCCCKKKK((((1111))))
  137.  
  138.  
  139.  
  140.            (by use of the alpha channel).
  141.  
  142.       ----HHHHcccc _R    _G _B
  143.            This specifies the color    to draw    in the hands with.
  144.  
  145.       ----hhhhcccc _R    _G _B
  146.            This specifies the color    to draw    the outlines of    the
  147.            hands.  If it is    not given, no outlines are drawn on
  148.            the edges of the    hands.
  149.  
  150.       ----ttttcccc _R    _G _B
  151.            This specifies the color    of the text above the clock.
  152.            It only has effect if a text height (-ty) is supplied.
  153.  
  154.       ----TTTTcccc _R    _G _B
  155.            This specifies the color    of a background    field to place
  156.            behind the text.     If omitted, no    background (zero alpha
  157.            channel)    is drawn.
  158.  
  159.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  160.       rrrrlllleeeeCCCClllloooocccckkkk
  161.            Generates a transparent clock face showing the current
  162.            time and    no digital representation.
  163.  
  164.       rrrrlllleeeeCCCClllloooocccckkkk ----ttttyyyy 33332222
  165.            Generates a current-time    clock with digital
  166.            representation above.
  167.  
  168.      111122228888 111122228888
  169.       rrrrlllleeeeCCCClllloooocccckkkk ----FFFFcccc 222255555555 0000 0000 ----HHHHcccc 0000 0000 222255555555 ----llllwwww 3333 ----ttttyyyy 99996666    ----ttttcccc 0000 222255555555 0000 ----TTTTcccc    111122228888
  170.            Generates a clock with a    red inside, white face,    blue
  171.            hands, wide lines, tall text field, green test, and
  172.            grey text background.
  173.  
  174.       rrrrlllleeeeCCCClllloooocccckkkk ----ttttyyyy 33332222 ----bbbbssss 11110000 ----bbbbvvvv 4444....55551111 ----llllssss 111100000000 ----llllvvvv 44445555....1111 ----ttttffff """"%%%%2222llll....%%%%2222....2222BBBB""""
  175.            Generates a clock with the scale    of the big hand    set to
  176.            10 and it's value at 4.51, the scale and    value of the
  177.            little hand as 100 and 45.1, and    the format for the
  178.            digital portion formatted as %%%%2222dddd....%%%%2222....2222ffff to print the
  179.            integer little hand value (two spaces) and the floating
  180.            point big hand value.
  181.  
  182.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  183.       _u_r_t(1), _R_L_E(5).
  184.  
  185.      AAAAUUUUTTTTHHHHOOOORRRR
  186.       Robert L. Brown, RIACS, NASA Ames Research Center
  187.  
  188.      BBBBUUUUGGGGSSSS
  189.       Not thoroughly checked when the line width is    cranked    up.
  190.       May dump core.
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 12/1/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      RRRRLLLLEEEECCCCLLLLOOOOCCCCKKKK((((1111))))         1111 ((((DDDDeeeecccc 11111111,,,,    1111999988887777))))           RRRRLLLLEEEECCCCLLLLOOOOCCCCKKKK((((1111))))
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.      Page 4                         (printed 12/1/98)
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.